home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / syr.z / syr
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  89 lines
  1. SYR(3F)                                               Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      SSSSYYRR, DDSSYYRR - Performs symmetric rank 1 update of a real or complex
  6.      symmetric matrix
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Real
  10.  
  11.         CCAALLLL SSSSYYRR ((_u_p_l_o,, _n,, _a_l_p_h_a,, _x,, _i_n_c_x,, _a,, _l_d_a))
  12.  
  13.      Double precision
  14.  
  15.         CCAALLLL DDSSYYRR ((_u_p_l_o,, _n,, _a_l_p_h_a,, _x,, _i_n_c_x,, _a,, _l_d_a))
  16.  
  17. IIMMPPLLEEMMEENNTTAATTIIOONN
  18.      IRIX systems
  19.  
  20. DDEESSCCRRIIPPTTIIOONN
  21.      These routines perform the following symmetric rank 1 operation:
  22.                        _T
  23.           _A <- _a_l_p_h_a _x_x  + _A
  24.             _T
  25.      where _x  is the transpose of _x, _a_l_p_h_a is a real or complex scalar, _x
  26.      is an _n-element vector, and _A is an _n-by-_n symmetric matrix.
  27.  
  28.      These routines have the following arguments:
  29.  
  30.      _u_p_l_o      Character*1.  (input)
  31.                Specifies whether the upper or lower triangular part of
  32.                array _a is referenced, as follows:
  33.  
  34.                _u_p_l_o= 'U' or 'u':  only the upper triangular part of _a is
  35.                referenced.
  36.                _u_p_l_o= 'L' or 'l':  only the lower triangular part of _a is
  37.                referenced.
  38.  
  39.      _n         Integer.  (input)
  40.                Specifies the order of matrix _A.  _n >= 0.
  41.  
  42.      _a_l_p_h_a     Scalar alpha.  (input)
  43.                SSSSYYRR: Real.
  44.                DDSSYYRR: Double precision.
  45.  
  46.      _x         Array of dimension 1+(_n-1) * |_i_n_c_x|.  (input)
  47.                SSSSYYRR: Real array.
  48.                DDSSYYRR: Double precision array.
  49.                Contains vector _x.
  50.  
  51.      _i_n_c_x      Integer.  (input)
  52.                Specifies the increment for the elements of _x.  _i_n_c_x must
  53.                not be 0.
  54.  
  55.      _a         Array of dimension (_l_d_a,_n).  (input and output)
  56.                SSSSYYRR: Real array.
  57.                DDSSYYRR: Double precision array.
  58.  
  59.                Before entry with _u_p_l_o = 'U' or 'u', the leading _n-by-_n
  60.                upper triangular part of array _a must contain the upper
  61.                triangular part of the symmetric matrix.  The strictly lower
  62.                triangular part of _a is not referenced.  On exit, the upper
  63.                triangular part of the updated matrix overwrites the upper
  64.                triangular part of array _a.
  65.  
  66.                Before entry with _u_p_l_o = 'L' or 'l', the leading _n-by-_n
  67.                lower triangular part of array _a must contain the lower
  68.                triangular part of the symmetric matrix.  The strictly upper
  69.                triangular part of _a is not referenced.  On exit, the lower
  70.                triangular part of the updated matrix overwrites the lower
  71.                triangular part of array _a.
  72.  
  73.      _l_d_a       Integer.  (input)
  74.                Specifies the first dimension of _a as declared in the
  75.                calling program.  _l_d_a >= MMAAXX(1,_n).
  76.  
  77. NNOOTTEESS
  78.      SSSSYYRR/DDSSYYRR is a Level 2 Basic Linear Algebra Subprogram (Level 2 BLAS).
  79.  
  80.      When working backward (_i_n_c_x < 0), each routine starts at the end of
  81.      the vector and moves backward, as follows:
  82.  
  83.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)), ..., _x(1)
  84.  
  85. SSEEEE AALLSSOO
  86.      HHEERR(3F)
  87.  
  88.      This man page is available only online.
  89.